NAME¶

pmempool-rm - remove a persistent memory pool

SYNOPSIS¶

$ pmempool rm [<options>] <file>..

DESCRIPTION¶

The pmempool rm command removes each specified file. If the specified file is a pool set file, all pool files (single-file pool or part files) and remote replicas are removed. By default the pmempool rm does not remove pool set files. All local and remote pool files are removed using unlink(3) call, except the pools created on device dax which are zeroed instead. If specified file does not exist, the remote pool is broken or not accessible, the pmempool rm command terminates with an error code. By default it prompts before removing write-protected local files. See REMOTE REPLICATION section for more details about support for remote pools. See EXAMPLES section for example usage of the rm command.

REMOTE REPLICATION¶

A remote pool is removed using rpmem_remove(3) function if librpmem(7) library is available. If a pool set file contains remote replication but librpmem(7) is not available, the pmempool rm command terminates with an error code, unless the -f, –force option is specified.

EXAMPLE¶

$ pmempool rm pool.obj pool.blk

Remove specified pool files.

$ pmempool rm pool.set

Remove all pool files from the “pool.set”, do not remove pool.set itself.

$ pmempool rm -a pool.set

Remove all pool files from the “pool.set”, remove the local pool set file and all remote pool set files.

SEE ALSO¶

pmempool(1), libpmemblk(7), libpmemlog(7), libpmemobj(7), librpmem(7) and <https://pmem.io>